Inside Macintosh: Telephony /

Chapter 1 - Introduction to Telephony on the Macintosh / Telephone Manager Initialization Reference

Telephone Manager Initialization Functions / Obtaining Tool IDs

TELGetProcID

Returns a tool ID for a given telephone tool.

pascal short TELGetProcID (Str255 name);

name

The name of the file (for example, "GeoPort Telephone Tool") that identifies a given telephone tool.

function result

The tool ID for a given telephone tool. If there is a telephone tool with the specified name in the Extensions folder, a tool ID is returned. The tool ID is dynamically assigned by the Telephone Manager and is subsequently used to refer to the telephone tool. If no telephone tool of the specified name can be located, TELGetProcID returns the value -1.

DESCRIPTION

The TELGetProcID function returns, as its function result, an ID for the tool that has the name specified by the name parameter. Your application should call this function before creating a new telephone record to establish a connection between the Telephone Manager and the telephone tool.

SPECIAL CONSIDERATIONS

Tool IDs are generated dynamically by the Telephone Manager at run time. As a result, you should not store a tool ID in a settings file as a means of identifying a particular tool. Instead, you should store the tool's name, which you can convert into a tool ID by calling TELGetProcID.